home *** CD-ROM | disk | FTP | other *** search
/ Mac Magazin/MacEasy 12 / Mac Magazin and MacEasy Magazine CD - Issue 12.iso / Sharewarebibliothek / Anwendungen / Wissenschaft & Technik / gpower202 / G•Power Read Me < prev    next >
Text File  |  1995-07-12  |  9KB  |  245 lines

  1. ========================================================================
  2.                         GPower for Macintosh, Version 2.0.2   June 1995
  3. ========================================================================
  4.  
  5. Contents of this document:
  6.  
  7. (1) Installation and registration
  8.  
  9. (2) What GPower does and how it works
  10.  
  11. (3) How to get GPower (i.e., where to check for future updates and
  12. versions for other platforms)
  13.  
  14. (4) Address for correspondence
  15.  
  16. (5) Disclaimer
  17.  
  18.  
  19. A more detailed description of the program and its background will be available
  20. soon in printed form:
  21.  
  22. Erdfelder, E., Faul, F. & Buchner, A. (in press). GPower: A general power
  23. analysis program. Behavior Research Methods, Instruments, & Computers.
  24.  
  25. Write to the authors if you are interested in receiving a preprint of this
  26. article.
  27.  
  28. ========================================================================
  29. (1) Installation and registration
  30. ========================================================================
  31.  
  32. GPower should run on any 68K Macintosh using System 6.0.7 or higher.
  33. It has also been tested successfully on some PowerMacintosh models 
  34. where it runs in emulation mode.
  35.  
  36. No special installation procedure is necessary to use GPower. Simply
  37. copy the program to your harddisk. If your Macintosh is equipped with
  38. an arithmetic coprocessor, you should use GPower/FPU, otherwise you
  39. MUST use GPower (GPower/FPU is much faster but it will not run on
  40. machines without FPU). Also, on PowerMacs you must use GPower because
  41. Apple’s 68k emulation does not support the FPU.
  42.  
  43. GPower is free. You may to give the program to friends and colleagues
  44. who might find it useful. Note that there is an MS-DOS version of
  45. GPower, so if your friends and colleagues use that platform, they can
  46. also work with GPower if they like (see Section (3) of this file for
  47. the FTP site to check for updates and the MS-DOS version of GPower).
  48.  
  49. We encourage you to let us know your complete address (including your
  50. e-mail address if possible) and the version of GPower you use. Please
  51. find our address in Section (4) below. As a registered user, you will
  52. be informed about future program revisions. Your personal data will be
  53. used for this purpose only.
  54.  
  55. We also ask you to report any errors or problems encountered with
  56. GPower to the address mentioned in Section (4) of this file.
  57.  
  58. What follows is a brief description of the program (it takes no more
  59. than five minutes to read it).
  60.  
  61.  
  62.  
  63. ========================================================================
  64. (2) What it does and how it works
  65. ========================================================================
  66.  
  67. GPower performs high-precision statistical power analyses for the most
  68. common statistical tests in behavioral research, that is, t-, F-, and
  69. Chi2-tests. The power values obtained by “accuracy mode” calculations
  70. of GPower are correct up to five significant digits at least. Although
  71. available for taking a quick look at a problem, we do not encourage
  72. “speed mode” calculations because they are less accurate.
  73.  
  74. GPower computes
  75.  
  76. (a) power values for given sample sizes, effect sizes and alpha-levels
  77. (post hoc power analyses);
  78.  
  79. (b) sample sizes for given effect sizes, alpha-levels, and power values
  80. (a priori power analyses);
  81.  
  82. (c) alpha- and beta-values for given sample sizes, effect sizes and
  83. beta/alpha-ratios (compromise power analyses).
  84.  
  85. It also displays graphically the relation between any two of the
  86. relevant variables.
  87.  
  88.  
  89. ----------------------- The “Analysis window” -----------------------
  90.  
  91. The “Analysis window” is used to specify the information necessary for
  92. a particular power analysis, and it displays the results of the last
  93. analysis.
  94.  
  95. Click “Calculate” to perform a single analysis for the Type of Power
  96. Analysis, the Type of Test, and the parameters you specified.
  97.  
  98. Click “Calc ES” (where ES is d, r, f, f2,  or w, depending on the type
  99. of test currently selected) to open a dialog in which you can specify
  100. the values necessary to calculate the effect size for your power
  101. analysis from empirical data (e.g., from published studies).
  102.  
  103. Click “Draw graph” to open a dialog in which you can specify the values
  104. necessary to display one parameter (e.g., the power) as a function of
  105. another parameter (e.g., the total sample size) over a range of values
  106. (e.g., from 20 to 220 subjects) in the “Graph window”.
  107.  
  108. If the “Graph window” is already open, you can simply double-click this
  109. window to open the dialog in which you can specify the graph
  110. parameters.
  111.  
  112.  
  113. ------------------------- The “Graph window” -------------------------
  114.  
  115. The “Graph window” can be used to display one parameter (e.g., the
  116. power) as a function of another parameter (e.g., the total sample size)
  117. over a range of values  (e.g., from 20 to 220 subjects).
  118.  
  119. The header of the graph always specifies the type of test, and the
  120. fixed values. The note below the graph tells you what calculation mode
  121. you used. Default is “Accuracy mode” which is very accurate (up to five
  122. significant digits at least) but the price is that you will usually
  123. have to wait a little longer until you see a result. “Speed mode”
  124. calculations are fast but they may not be very accurate (particularly
  125. for ‘extreme’ values). If you selected “Speed mode”, do not trust the
  126. results too much!
  127.  
  128. You can copy the graph using “Copy graph” from the “Edit” menu and
  129. paste it into your word processor or drawing program documents for
  130. saving or editing the graph information. Inside GPower you cannot edit
  131. or save a graph.
  132.  
  133. The scaling of the axes in the “Graph window” depends on the size of
  134. the window, so re-sizing the window may have the effect of a more
  135. fine-grained scaling.
  136.  
  137. If the “Protocol (table)” option in the “Graph dialog” is on, a table
  138. of the values used to plot the graph is written to the Result window.
  139. This table can be imported into your favorite graphics package, either
  140. via the clipboard or by saving the table as a GPower file (see below).
  141.  
  142.  
  143. ------------------------- The “Result window” -------------------------
  144.  
  145. If the “Result window” is open, all parameters of all power analyses
  146. performed in the “Analysis window” are recorded here.
  147.  
  148. The “Result window” is fully editable (using the commands from the Edit
  149. menu). You can either copy the values you need to the clipboard, or you
  150. can save the entire information of the “Result window” to a GPower
  151. file using the Save or Save as commands from the File menu.
  152.  
  153. Double-clicking such a file launches GPower and opens the file so you
  154. can record more analyses in it. However, because GPower files are of
  155. type TEXT, they may also be opened from inside your favorite word
  156. processor or graphics package.
  157.  
  158.  
  159.  
  160. ========================================================================
  161. (3) How to get GPower
  162. ========================================================================
  163.  
  164. The most convenient way to get a copy of GPower is to download the
  165. program from the public FTP server at the University of Trier,
  166. Germany. This is where you should check for updates and future
  167. releases, and for versions for other platforms of GPower.  However,
  168. we will also try to make available updates and future releases of the
  169. Macintosh version on an info-mac archive near you.
  170.  
  171. 1. Open the FTP session: FTP ftp.uni-trier.de
  172.  
  173. 2. Log on: user anonymous
  174.  
  175. 3. Enter the password: Your e-mail address.
  176.  
  177. 4. Set the file type to binary (omitting to set the file type properly
  178. is a frequent error!) binary
  179.  
  180. 5. Change directory: 
  181.  
  182. (a) if you want the MS-DOS-version of GPower:
  183.  
  184.     cd /pub/pc/msdos-local
  185.  
  186. (b) if you want the MACINTOSH-version of GPower: 
  187.  
  188.     cd /pub/mac/local
  189.  
  190. 6. Start downloading (make sure to type the file names exactly as indicated
  191. below, this procedure is case-sensitive):
  192.  
  193. (a) if you want the MS-DOS-version of GPower:
  194.  
  195.     get gpower2i.exe (international version) or
  196.     get gpower2d.exe (German version)
  197.  
  198. (b) if you want the MACINTOSH-version of GPower: 
  199.  
  200.     get gpower2.sit
  201.  
  202. 7. Finish the FTP session: quit
  203.  
  204. 8. Convert the compressed file to a standard DOS- or MACINTOSH-file:
  205.  
  206. (a) DOS-version (self-extracting archive): gpower2i.exe (international
  207. version) or gpower2d.exe (German version). This will create a
  208. subdirectory GPOWER in your current working directory which will
  209. contain all necessary files.
  210.  
  211. (b) MACINTOSH-version: Open the file gpower2.sit from a version of 
  212. StuffIt or use the Stuffit Expander.
  213.  
  214.  
  215. ========================================================================
  216. (4) Address for correspondence
  217. ========================================================================
  218.  
  219. Please report bugs and suggestions to improve the program to:
  220.  
  221. Axel Buchner
  222. FB I - Psychologie
  223. Universität Trier
  224. Universitätsring 15
  225. D-54286
  226. Trier Germany
  227.  
  228. E-mail: buchner@cogpsy.uni-trier.de
  229.  
  230.  
  231.  
  232. ========================================================================
  233. (5) Disclaimer
  234. ========================================================================
  235.  
  236. We hereby disclaim all warranties relating to this software, whether
  237. expressed or implied, including without limitation any implied
  238. warranties of merchantability or fitness for a particular purpose.  We
  239. will not be liable for any special, incidental, consequential, indirect
  240. or similar damages due to loss of data or any other reason, even if we
  241. or agents of ours have been advised of the possibility of such damages.
  242.  In no event shall we be liable for any damages, regardless of the form
  243. of the claim. The person using the software bears all risk as to the
  244. quality and performance of the software.
  245.